Update the department's limit on the cost of taxi trips

This request is used to update the department's limit on the cost of trips in a Taxi service.

Request syntax

POST https://b2b-api.go.yandex.ru/integration/2.0/departments/limits/taxi/update?department_id={department ID}

Request headers

  • Authorization: Bearer <OAuth-token>
    OAuth access token. The steps to get a token are described in Getting started.
  • X-YaTaxi-Selected-Corp-Client-Id — client ID from the account. Required if multiple clients are available using the token.

Request parameters

The request contains the following required parameter:

  • department_id: department ID.

Request body

Warning

Body is required in this request!

Data is passed in the request body in JSON format:

Field

Description

Format

Required

budget

The amount that the department can spend per month on trips in the Taxi service. The value null means that there is no limit on the cost of trips per month.

Number

Yes

Request example

POST https://b2b-api.go.yandex.ru/integration/2.0/departments/limits/taxi/update?department_id=87e8...646c
...
Authorization: Bearer <OAuth-token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>

    { 
        "budget": 1000
    }

Response example

If the request is successful, an empty 200 response is returned.

Response codes

The response to this request may contain the following standard HTTP codes:

  • 200: Request completed successfully.
  • 400: An unknown parameter or a parameter with an invalid value was passed in the request.
  • 401: The OAuth token is incorrect.
  • 403:
    • SELECT_CLIENT_HEADER_REQUIRED: the request did not pass the header X-YaTaxi-Selected-Corp-Client-Id (returned if more than one client is available for the token).
    • SELECTED_CLIENT_ACCESS_DENIED: the header X-YaTaxi-Selected-Corp-Client-Id contains the client's ID, which this login does not have access to.
  • 404: There is no department with the specified department_id.